---
layout: m1x_rest
title: GET Filters
---
<p>Some requests use GET parameters in the URL. These are as follows:</p>

<ul>
	<li><b>filter</b> &#45; specifies the filters for returned data</li>
	<li><b>page</b> &#45; specifies the page number which items will be returned
	<ul>
		<li>e.g., http://magentohost/api/rest/products?page=1</li>
	</ul>
	</li>
	<li><b>order</b>, <b>dir</b> &#45; specifies the sort order of returned items and the order direction: 'asc' - returns items in the ascending order; 'dsc' - returns items in the descending order.
	<ul>
		<li>e.g., http://magentohost/api/rest/products?order=name&amp;dir=dsc</li>
		<li>e.g., http://magentohost/api/rest/products?order=name&amp;dir=asc</li>
	</ul>
	</li>
	<li><b>limit</b> &#45; limits the number of returned items in the response. Note that by default, 10 items are returned in the response. The maximum number is 100 items.
	<ul>
		<li>e.g., http://magentohost/api/rest/products?limit=2</li>
	</ul>
	</li>
	<li><b>neq</b> &#45; "not equal to" - returns items with the specified attribute that is not equal to the defined value
	<ul>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=entity_id&amp;filter\[1\]\[neq\]=3">http://magentohost/api/rest/products?filter[1][attribute]=entity_id&amp;filter[1][neq]=3</a></li>
	</ul>
	</li>
	<li><b>in</b> &#45; "equals any of" - returns items that are equal to the item(s) with the specified attribute(s)
	<ul>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=entity_id&amp;filter\[1\]\[in\]=3">http://magentohost/api/rest/products?filter[1][attribute]=entity_id&amp;filter[1][in]=3</a></li>
	</ul>
	</li>
	<li><b>nin</b> &#45; "not equals any of" - returns items excluding the item with the specified attribute
	<ul>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=entity_id&amp;filter\[1\]\[nin\]=3">http://magentohost/api/rest/products?filter[1][attribute]=entity_id&amp;filter[1][nin]=3</a></li>
	</ul>
	</li>
	<li><b>gt</b> &#45; "greater than" - returns items with the specified attribute that is greater than the defined value
	<ul>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=entity_id&amp;filter\[1\]\[gt\]=3">http://magentohost/api/rest/products?filter[1][attribute]=entity_id&amp;filter[1][gt]=3</a></li>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=price&amp;filter\[1\]\[gt\]=300">http://magentohost/api/rest/products?filter[1][attribute]=price&amp;filter[1][gt]=300</a></li>
	</ul>
	</li>
	<li><b>lt</b> &#45; "less than" - returns items with the specified attribute that is less than the defined value
	<ul>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=entity_id&amp;filter\[1\]\[lt\]=4">http://magentohost/api/rest/products?filter[1][attribute]=entity_id&amp;filter[1][lt]=4</a></li>
	</ul>
	</li>
	<li><b>from</b>, <b>to</b> &#45; specifies the range of attributes according to which items will be returned
	<ul>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=entity_id&amp;filter\[1\]\[from\]=1&amp;filter\[1\]\[to\]=3">http://magentohost/api/rest/products?filter[1][attribute]=entity_id&amp;filter[1][from]=1&amp;filter[1][to]=3</a></li>
		<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=price&amp;filter\[1\]\[from\]=150&amp;filter\[1\]\[to\]=350">http://magentohost/api/rest/products?filter[1][attribute]=price&amp;filter[1][from]=150&amp;filter[1][to]=350</a></li>
	</ul>
	</li>
</ul>


<p>If the attribute value consists of several words separated by a whitespace, the '%20' sign is used:</p>
<ul>
	<li>e.g., <a href="http://magentohost/api/rest/products?filter\[1\]\[attribute\]=name&amp;filter\[1\]\[in\]=BlackBerry%208100%20Pearl">http://magentohost/api/rest/products?filter[1][attribute]=name&amp;filter[1][in]=BlackBerry%208100%20Pearl</a></li>
</ul>


<p>For example, to filter products with the description equal to simple01:</p>

<p><a href="http://magentohost/api/rest/products/?order=entity_id&amp;filter\[0\]\[attribute\]=description&amp;filter\[0\]\[in\]\[0\]=simple01">http://magentohost/api/rest/products/?order=entity_id&amp;filter[0][attribute]=description&amp;filter[0][in][0]=simple01</a></p>


		    
